home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / tag_bbs / alter1.zip / ALTERWHO.DOC next >
Text File  |  1992-10-08  |  6KB  |  244 lines
  1.  
  2.                                  Alterwho?
  3.  
  4.                               BETA version 1.0
  5.  
  6.                 A T.A.G. Utility for Multiuser T.A.G. SysOps
  7.  
  8.  
  9.  
  10.  
  11. Written by:     Melanie A. Meyer
  12.                 The Snooze Button BBS
  13.                 Glen Burnie, Maryland
  14.  
  15.  
  16.                 Node 1 1:261/1106   (410)766-4058  USR Dual Standard
  17.                                                    V.32bis, HST
  18.  
  19.  
  20.                 Node 2 1:261/1156   (410)766-0640  Practical Peripherals
  21.                                                    PM14400FXSA V.32bis
  22.  
  23.  
  24.  
  25.  
  26. Registration   There isn't any!  This program is free.  You may use it for
  27.                as long as you like.
  28.  
  29.  
  30.  
  31.  
  32.  
  33. Disclaimer     This program is not guaranteed to do anything except take
  34.                up space on your hard drive.  However, after testing it on
  35.                my own multiuser T.A.G. BBS, version 2.6c, I have found it 
  36.                to do the job quite nicely.
  37.  
  38.  
  39.  
  40.  
  41.  
  42. Share Aware?   Yes.  This program utilizes file sharing/locking routines
  43.                by Mike Woltz BCSHARE (C) 1990, Buffalo Creek Software, and
  44.                *SHOULD* work properly on systems operating in multitasking
  45.                environments.
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. +===========================================================================+
  69.  
  70.  
  71.                               What This Does...
  72.  
  73.      The program alterwho.exe will read the contents of a configuration
  74.      file, and then change the long description in the $who.dat file.
  75.  
  76.  
  77.  
  78.  
  79.                            Why would you use it?
  80.  
  81.      After a user logs off of a T.A.G. board that is run with a front end
  82.      mailer, T.A.G. exits and changes the long description in the $who.dat
  83.      file to "Down".  Suppose Muffy Button entered the Whos Online command.
  84.      This is what she would see:
  85.  
  86.  
  87.      Node 1: Down
  88.      Node 2: Muffy Button from Glen Burnie, Md at 2400 baud
  89.      Node 3: Down
  90.  
  91.  
  92.      So to change this, the Sysop would execute alterwho.exe AFTER T.A.G.
  93.      exited, and BEFORE the batch file loaded the front end mailer.
  94.  
  95.  
  96.  
  97.      Suppose you wanted SysOp Steve to see:
  98.  
  99.      Node 1: Muffy Button from Glen Burnie, Md  (2400 baud)
  100.              In the GAMES again!
  101.      Node 2: Still waiting...
  102.      Node 3: Sysop Steve from Glen Burnie, Md   (keyboard)
  103.  
  104.      instead of:
  105.  
  106.      Node 1: Muffy Button from Glen Burnie, Md  (2400 baud)
  107.              In a door
  108.      Node 2: Down
  109.      Node 3: Sysop Steve from Glen Burnie, Md   (keyboard)
  110.  
  111.      when doing a Whos Online...
  112.  
  113.  
  114.      You would execute alterwho from the batch file that called the game,
  115.      specifying in the command line a config file that had the following
  116.      contents:
  117.  
  118.  
  119.      In the GAMES again!          <-- Text for Long Description
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131. +============================================================================+
  132.  
  133.                                   Setup
  134.  
  135.  
  136.      Easy.
  137.  
  138.      1)  Put ALTERWHO.EXE in your Multinode Directory (the directory
  139.          where $who.dat resides..)
  140.  
  141.      2)  Create Configuration files in the Multinode Directory
  142.          for each task.
  143.  
  144.      3)  Insert a call to ALTERWHO into your batch files.
  145.  
  146.      Done.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.                            Configuration Files
  154.  
  155.  
  156.          Waiting.cfg - Used in mailer batch file after T.A.G. exits:
  157.  
  158.  
  159.          Waiting for NEXT VICTIM   <-  Text to display in description,
  160.                                        followed by a CR (ENTER)
  161.                                        64 character maximum
  162.  
  163.  
  164.          Game.cfg - Used in Online Game batch file before game is executed:
  165.  
  166.  
  167.          Playing Games!            <- Text to appear in the description,
  168.                                       followed by a CR.  64 char max
  169.  
  170.  
  171.  
  172.  
  173.  
  174.          OR, as Arthur Ward suggested, if you are already using a Logoff.bat
  175.          file, place a call to ALTERWHO at the beginning of the Logoff.bat
  176.          and use a config file like this:
  177.  
  178.          logoff.cfg
  179.  
  180.  
  181.          Logging off the System ALREADY!
  182.  
  183.          Normally T.A.G. reports that the user is "In a Door" when the
  184.          logoff.bat is running.
  185.  
  186.  
  187.          The Configuration files can be named anything you like.  I suggest
  188.          you make the name indicative of what you are doing, for the sake of
  189.          clarity in the event you use Alterwho frequently.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199. +=============================================================================+
  200.                                 Color Codes
  201.  
  202.  
  203.  
  204.          Yes.. you can use T.A.G. color codes in the config files.  And to
  205.          make it easy, I've included a function that changes any '^'
  206.          encountered into a T.A.G. Contol-P color code.
  207.  
  208.          example:
  209.  
  210.          Waiting.cfg
  211.  
  212.  
  213.          ^6Waiting for a ^9CALLER ^2!
  214.  
  215.          "Waiting for a " would be  in color number 6.  "CALLER " would be
  216.          in color number 9 and "!" would display in color number 2.
  217.  
  218.          Just place a carat(^), followed by a number from 0-9 in the text.
  219.  
  220.  
  221.                       Calling ALTERWHO From Batch Files
  222.  
  223.  
  224.          cd\Multi                           <- Change to Multinode Dir
  225.          alterwho 1  Waiting.CFG            <- Execute ALTERWHO on node 1
  226.                                                and use waiting.cfg for the
  227.                                                text.
  228.          cd\wherever                        <- Change Directories back to
  229.                                                where you need to be.
  230.  
  231.  
  232.          So the complete command line is:
  233.  
  234.          alterwho <node number> <configuration filename>
  235.  
  236.  
  237.  
  238.  
  239.    Well.. Thats about it.  If you have any trouble, please notify me
  240.    at FIDO 261/1156 or 261/1106.  Thanks..
  241.  
  242.                                           Melanie A. Meyer
  243.  
  244.